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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3' Generation Partnership Project (3GPP). 

The present document is part 3 of a muhi-part TS covering the 3"* Generation Partnership Project: Technical 
Specification Group Services and System Aspects, as identified below: 

Part 1: "3G Fault Management Requirements"; 

Part 2: "Alarm Integration Reference Point: Information Service"; 

Part 3: "Alarm Integration Reference Point: CORBA Solution Set Version 1:1"; 

Part 4: "Alarm Integration Reference Point: CMIP Solution Set". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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1 Scope 



The present document specifies the CORBA Solution Set (SS) for the IRP whose semantics is specified in Alarm IRP: 
Information Service (IS) (3GPP TS 32.111-2 [13]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 defines the usage of OMG CORBA Structured Event to carry information defined in notifications carrying 
alarm information. Clause 7 describes the notification interface containing the push method. Annex A contains the IDL 
specification. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 



• 



References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] ITU-T Recommendation X.721: "Information technology - Open Systems Interconnection - 
Structure of management information: Definition of management information". 

[2] ITU-T Recommendation X.736: "Information technology - Open Systems Interconnection - 

Security Alarm Reporting Function". 

[3] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - 

Relationship Management Function" . 

[4] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - State 

Management Function" . 

[5] ITU-T Recommendation X.732: "Information technology - Open Systems Interconnection - 

Object Management Function". 

[6] OMG TC Document telecom/98-1 1-01: "OMG Notification Service". 

[7] OMG CORBA Services: "Common Object Services Specification, Update: November 22, 1996" 

(Clause 4 contains the Event Service specification). 

[8] 3GPP TS 32.106-8: "Name Convention for Managed Objects". 

[9] 3GPP TS 32.106-1: "3G Configuration Management: Concept and Requirements". 

[10] 3GPP TS 32.106-2: "Notification IRP: Information Service". 

[II] 3GPP TS 32.106-3: "Notification IRP: CORBA Solution Set". 
[12] 3GPPTS 32.111-1: "3G Fault Management". 

[13] 3GPP TS 32.111 -2: "Alarm Integration Reference Point: Information Service" . 

[14] 3GPP TS 32.1 1 1-4: "Alarm Integration Reference Point: CMIP Solution Set". 
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3 Definitions and abbreviations 

3.1 Definitions 

In addition to the terms and definitions defined in 3GPP TS 32.111-2 [13], there are no additional definitions applicable 
to the present document. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

MOC Managed Object Class 

MOl Managed Object Instance 

NE Network Element 

OMG Object Management Group 

TMN Telecommunications Management Network 

UML Unified Model Language 

3.3 IRP Solution Set version 

The version of this CORBA SS is 1:1, where the first "1" indicates the version number of the Alarm IRP: IS 
(3GPP TS 32.111-2 [13]) and the second "1" indicates the version number of the present document. 



4 Architectural features 

The overall architectural feature of Alarm IRP is specified in 3GPP TS 32.1 1 1-2 [13]. This clause specifies features 
that are specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Alarm Information to IRPManager via OMG Notification 
Service (OMG TC Document telecom [6]). 

OMG Event Service provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality Of Service (QOS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
AlarmlRPNotifications notifications as specified in 3GPP TS 32.111-2 [13]. 



4.2 Push and Pull Style 



OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

This CORBA SS specifies that support of Push style is Mandatory (M) and that support of Pull style is Optional (O). 
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4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each 
push invocation. 



4.4 



Filter 



IRP Agent shall optionally support alarm filtering based on IRPManager's supplied alarm filter constraints (e.g., as 
parameter in subscribe() of 3GPP TS 32.106-2 [10]. Alarm filtering can be applied in the following cases: 

• It is applicable to alarms emitted by IRP Agent via AlarmlRPNotif ications. IRPManager supplies alarm 
filter constraint via the subscribe method. This filter is effective during the period of subscription. 

• It is applicable to alarms returned by IRP Agent via the out parameter of get_alarm_list method. 
IRPManager supplies alarm filter constraint via the get_alarm_list method. This filter is effective only for 
this method invocation. 

• It is applicable to the calculation of alarm counts returned by IRP Agent via the out parameters of 
get_alarm_count method. IRPManager supplies alarm filter constraint via the get_alarm_count 
method. This filter is effective only for this method invocation. 

This SS shall use of filter constraint grammar specified by reference 3GPP TS 32. 106-2 [ 10] . The name of the grammar 
is called "EXTENDED_TCL". See clause 2.4, Default Filter Constraint Language in 3GPP TS 32.106-2 [10]. This SS 
shall use this grammar only. 



5 IVIapping 

5.1 Operation and Notification mapping 

Alarm IRP: IS 3GPP TS 32.111-2 [13] defines semantics of operation and notification visible across the Alarm IRP. 
Table 1 indicates mapping of these operations and notifications to their equivalents defined in this SS. 



Table 1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation/ notification 3GPP TS 32.111-2 
[13] 


^^^^^^^ SS Method ^|m||^^_ 


Qualifier 


^^^^^^^EL . 


acknowledgeAlarms 


acknowledge_alarms 


M 


unacknowl edge Alarms 


una cknowledge_al arms 


O 


getAlarmList 


get_alarm_list 


M 


getAlarmlRPVersion 


get_alarm_IRP_version 


M 


getAlarmCount 


get_alarm_count 





notifyNewAlarm 


push_structured_events 

Note that OMG Notification Service 3GPP TS 32.106-2 

[10] defines this method. See clause 8.1 


M 


notif yClearedAlarm 


push_structured_events 
See clause 8.1 


M 


notifyChangedAlarm 


push_structured_events 
See clause 8.1 


M 


notifyAckStateChanged 


push_structured_events 
See clause 8.1 


M 


not ifyAlarmLi St Rebuilt 


push_structured_events 
See clause 8.1 


M 
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5.2 Operation parameter mapping 



Reference 3GPP TS 32.111-2 [13] defines semantics of parameters carried in operations across the Alarm IRP. Table 2 
and table 3 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 



Table 



2: Mapping from IS acknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmlnf ormation 
Ref erenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
alarm_inf ormation_id_list 


M 


ackUserld 


string ack_user_id 


M 


ackSystemld 


string ack_system_id 





bad Alarmlnf ormation 
Ref erenceList 


AlarmlRPConstDef s : : AlarmlnformationldSeq 
bad_alarm_inf ormation_id_list 


M 


status 


CommonlRPConstDef s : : Signal 
Exceptions: 

AcknowledgeAlarms, ParameterNot Supported, 
InvalidParameter 


M 



Table 3: Mapping from IS unacknowledgeAlarms parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarm 

InformationRef erenceList 


AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
a 1 a r m_i n f o r ma t i on_i d_l i s t 


M 


ackUserld 


string ack_user_id 


M 


ackSystemld 


string ack_system_id 





badAlarm Information 
ReferenceList 


AlarmlRPConstDef s : : AlarmlnformationldSeq 
bad_alarm_inf ormation_id_list 


M 


status 


CommonlRPConstDef s : : Signal 
Exceptions: 

UnacknowledgeAlarms, Ope rat ionNot Supported, 
ParameterNot Supported, InvalidParameter 


M 



Table 4: Mapping from IS getAlarmLlst parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 





alarmlnf ormation List 


Return value of type 

AlarmlRPConstDef s : : Alarmlnf ormationSeq 


M 


status 


Exceptions: 

GetAlarmLlst, ParameterNot Supported, 
InvalidParameter 


M 



Table 5: Mapping from IS getAlarmCount parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


alarmAckState, filter 


string filter 





criticalCount , majorCount, 
minorCount, warningCount , 
indeterminateCount , clearedCoun 
t 


long critical_count , long major_count, long 
minor_count, long warning_count , long 
indeterminate_count, long cleared_count 


M 


status 


Exceptions: 

GetAlarmCount, Ope rat ionNot Supported, 
ParameterNot Supported, InvalidParameter 


M 
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Table 6: Mapping from IS getAlarmiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberList 


Return value of type 

CommonlRPConstDef s : : VersionNumberSet 


M 


status 


Exceptions: 

GetAlarmiRPVersion 


M 



5.3 Notification parameter mapping 



Reference 3GPPTS 32.111-2 [13] defines semantics of parameters carried in notifications across the Alarm IRP. Table 
7 and table 8 indicate the mapping of these parameters, as per notification, to their equivalents defined in this SS. 

Table 7 and table 8 are relevant for notifyNewAlarm, notifyChangedAlarm, notifyClearedAlarm, 
not i fyAck Stat eChanged. 

Table 7: lUlapping from IS notify [New, changed. Cleared] Alarm 

and notifyAckstateChanged parameters to SS equivalents 



IS Notification 
parameter 


SS Notification 
parameter 


Comment 


notification 
Header 


structuredEvent 
Note that OMG 
Notification Service [6] 
defines this 
StructuredEvent. 
See Clause 4 as well. 


Attributes of notif IcationHeader are mapped to attributes of 
StructuredEvent. See clause 5.4 for attributes related to 
notif IcationHeader. See Table 9 for qualifiers for the parameter- 
attributes. 

For notifyNewAlarm, notifyChangedAlarm, notifyClearedAlarm 

and notifyAckstateChanged, the extendedEventType shall 

contain a string of extendedEventlypeValue .notify_fm_new_alarm, 

extendedEventTypeValue.NOTIFY_FM_CHANGED_ALARM, 

extendedEventTypeValue.NOTIFY_FM_CLEARED_ALARM, 

extendedEventTypeValue.NOTIFY_FM_ACK_STATE_CHANGED 

respectively. 


alarm 

Information 

Body 


StructuredEvent 


Attributes of aiarminf ormationBody are mapped to attributes of 
StructuredEvent. See clause 5.4 for attributes related to 
aiarminf ormationBody. See table 1 for qualifiers for the parameter- 
attributes. 



Table 8 is relevant for notif yAlarmListRebuilt. 

Table 8: IVIapping from IS notif yAlarmListRebuilt parameters to SS equivalents 



IS Notification parameter 


SS equivalent 


Comment 


notification Header 


structuredE 
vent 


Attributes of notif icationHeader are mapped to attributes of 

StructuredEvent. 

See clause 5.4 for attributes related to notif icationHeader. 

See Table 9 for qualifiers for the parameter-attributes. 

The event Type shall contain a zero-length string. 

The extendedEventType shall contain a string of 

extendedEventTypeValue.NOTIFY_FM_ALARM_LIST_REBUILT. 

The managedOb jectlnstance shall carries the DN of the IRP Agent 

whose Alarm List has been rebuilt. 

Syntax and semantics of this string conform to the Managed Object string 

representation specified in [8]. 


reason 


reason 


It is a string indicating the Alarm List rebuilt reason. 

See 3GPP TS 32.1 1 1-2 [13] for qualifiers for the parameter-attributes. 
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5.4 Parameter Attribute mapping 

Notification IRP: IS 3GPP TS 32.106-2 [10] defines the semantics of attributes for notif icationHeader 
parameter. Alarm IRP: IS 3GPPTS 32.111-2 [13] identifies notif icationHeader for use for its IRP. 
3GPP TS 32.111-2 [13] also qualifies the attributes of the notif icationHeader parameter. Table 9 shows the 
mapping of these IS attributes to SS equivalents. 

Table 9: Mapping from IS notif icationHeader attributes to SS equivalents 



IS Attribute of notif icationHeader in [10] 


SS Attribute 


Qualifier 


managedObject Class 


managedObject Class 


M 


managedObject In stance 


managedObject In stance 


M 


notif icat ion ID 


notif icat ion ID 


M 


eventTime 


eventTime 


M 


systemDN 


systemDN 


M 


eventType 


eventType 


M 


extendedE vent Type 


extendedE vent Type 


M 



Alarm IRP: IS 3GPP TS 32. 1 1 1-2 [13] defines and qualifies the semantics of attributes for 

aiarminf ormationBody parameter. The following table shows the mapping of these IS attributes to SS 

equivalents. 

Table 10: Mapping from IS alarminformationBody attributes to SS equivalents 



IS Attribute of alarminformationBody in 
3GPPTS 32.111-2 [13] 


SS Attribute 


Qualifier 


probabieCause 


probabieCause 


M 


perceivedSeverity 


perceivedSeverity 


M 


specif icProbiem 


specif icProblem 


O 


correiatedNot if icat ions 


correiatedNot if icat ions 


O 


backedUpStatus 


backedUpStatus 


o 


backUpOb ject 


backUpOb ject 





trendlndication 


trendlndication 


o 


thresholdlnfo 


thresholdlnfo 


o 


stateChangeDefinition 


StateChangeDefinition 


o 


monitoredAttributes 


monitoredAttributes 





proposedRepair Act ions 


proposedRepair Act ions 


o 


additionaiText 


additionaiText 


o 


additionalinf ormation . alarmld 


alarmld 


M 


additionallnformation. ackTime 


ackTime 


note 1 


additionalinf ormation . ackUserld 


ackUserld 


note 1 


additionallnformation . ackSystemld 


ackSystemld 


note 1 


additionallnformation. ackState 


ackState 


note 1 


NOTE 1 : See qualification information in 3GPP TS 32. 11 1 -2 [ 1 3] , Table 1 3 : Parameter- Attributes of 

alarminformationBody. 
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Use of OMG Structured Event 



Operation notify defined in 3GPP TS 32.111-2 [13] carries parameters, such as notif icationHeader and 
alarmlnf ormationBody. In CORBA SS, OMG defined StructuredEvent (see ITU-T Recommendation 
X.736 [2]) is used to carry notification. This clause identifies the OMG defined StructuredEvent attributes that 
carry the attributes of parameters defined in 3GPPTS 32.111-2 [13]. 

The composition of OMG Structured Event, as defined in the OMG TC Document telecom [6], is: 



Header 



Body 



Fixed Header 

doma i n_n ame 

tYpe_name 

event_name 
Variable Header 

f i Iter able_bodY_f ields 
remaining_body 



Table 1 1 lists all OMG Structured Event attributes in the second column. The first column identifies the SS attributes, 
if any, that shall be carried in the Structured Event attributes. 

Attributes that are denoted as "optional" in subclause 5.4 of the present document may be absent from the OMG 
Structured Event. As an example, if the optional monitoredAttributes attribute is not used for a particular 
notification, then the IRP Agent may exclude monitoredAttributes from the filterable body fields for that 
particular notification. Individual notifications from the same IRP Agent may include or exclude the same optional 
attribute. 

Table 11 : Use of OMG Structured Event 



SS Attribute 


OMG CORBA 

Structured Event 

attribute 


Comment 


There is no 
corresponding SS 
attribute. 


doma in_n ame 


It contains a string defined by interface 

IRPNotif icationCategoryValue . alarmIRPVersion_l_l. It 
indicates tlie syntax and semantics of this Structured Event defined by 
Alarm IRP: CORBA SS 1:1. 


eventType 


tYpe_name 


Attribute eventType is an attribute of notif icationHeader. 

It shall indicate one of the following ITU-T defined semantics: 

communications alarm, processing error alarm, environmental alarm, 

quality of service alarm and equipment alarm. 

It is a string. See block of const string definitions starting with "ET " in the 

IDL 


extendedEvent 
Type 


event_name 


Attribute extendedEventType is an attribute of notif icationHeader. 
It shall identify one of the following: 

- notify a new alarm 

- notify changes in alarm state 

- notify changes in alarm acknowledgement state 

- notify alarm cleared 

- notify Alarm List has been successfully rebuilt 

It is a string. See block of const string definitions starting with 
"NOTiFY_FM_" in the IDL. 


Tliere is no 
corresponding SS 
attribute. 


variable Header 




managedOb ject 
Class, 

managedOb ject I 
nstance 


One NV pair of 

f ilterable_ 
bodY_f ields 


NV stands for name-value pair. Order arrangement of NV pairs is not 

significant. The name of NV-pair is always encoded in string. 

They are attributes of notif icationHeader. 

Name of NV pair is a string, NV_MANAGED_OBJECT_INSTANCE defined 

in module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in Notification IRP: 

CORBA SS {3GPP TS 32.106-3 [11]). 
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SS Attribute 


OMG CORBA 

Structured Event 

attribute 


Comment ^^^^ 


notification 
Id 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader. 

Name of NV pair is a string, NV_NOTIFICATION_ID defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification IRP: 

CORBA SS {3GPP TS 32.106-3 [11]). 


eventTime 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader . 

Name of NV pair is NV_EVENT_TIME defined in module 

NotificationlRPConstDefs . 

Value of NV pair is a IRPTime. See corresponding table in Notification 

IRP: CORBA SS (3GPP TS 32.106-3 [11]). 


systemDN 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of notif icationHeader. 

Name of NV pair is a string, NV_SYSTEI\/I_DN defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in Notification IRP: 

CORBA SS [11]. 


probableCause 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, NV_PROBABLE_CAUSE defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a short defined by PC INDETERMINATE, 

PC ALARM INDICATION SIGNAL, etc. 


perceived 
Severity 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, NV_PERCEIVED_SEVERITY defined in 

module NotificationlRPConstDefs. 

Value of NV pair is a short defined by PS INDETERMINATE, 

PS CRITICAL, etc. 


specific 
Problem 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, NV_SPECIFIC_PROBLEM defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a string. 


correlated 
Notifications 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, NV_CORRELATED_NOTIFICATIONS defined 

in module NotificationlRPConstDefs. 

Value of NV pair is a CorrelatedNotif icationSetlype . 


backed 
UpStatus 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnf ormationBody. 

Name of NV pair is a string, NV_BACKED_UP_STATUS defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a boolean BackedUpStatusType. 


backUpOb ject 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_BACK_UP_OBJECT defined in module 

NotificationlRPConstDefs. 

Value of NV pair is a string carrying of DN of the back-up object. See 

3GPP TS 32.106-8 [8] for the DN string representation. 


trend 
Indication 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_TREND_INDICATION defined in module 

NotificationlRPConstDefs. 

Value of NV pair is an enum TrendlndlcatlonType. 


thresholdlnfo 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_THRESHOLD_INFO defined in module 

NotificationlRPConstDefs. 

Value of NV pair is an enum ThresholdlndlcatlonType. 


stateChange 
Definition 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_STATE_CHANGE_DEFINITION defined 

in module NotificationlRPConstDefs. 

Value of NV pair is an AttributeChangeSetlype . 


monitored 
Attributes 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_MONITORED_ATTRIBUTES defined in 

module NotificationlRPConstDefs. 

Value of NV pair is an AttributeSetiype. 


proposed 
RepairActions 


One NV pair of 

f ilterable_ 
body_f ields 


It is an attribute of alarmlnformationBody. 

Name of NV pair is a string, NV_PROPOSED_REPAIR_ACTIONS defined 

in module NotificationlRPConstDefs. 

Value of NV pair is a string. 
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SS Attribute 


OMG CORBA 

Structured Event 

attribute 


Comment ^^^^ 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Text 


f ilterable_ 


Name of NV pair is a string, NV ADDITIONAL TEXT defined in module 




bodY_f ields 


NotificationlRPConstDefs. 
Value of NV pair is a string. 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Information . al 


f ilterable_ 


Name of NV pair is a string, NV ALARIVI ID defined in module 


armid 


bodY_f ields 


NotificationlRPConstDefs. 

Value of NV pair is a string. 

If the string is a zero-length string or if this NV pair is absent, the default 

semantics is that aiarmid is a concatenation of 

managedOb jectlnstance, eventType, probableCause and 

specif icProbiem, if present, of this Structured Event. Since 

probabieCuase is encoded as a short, it shall be converted into string 

before concatenation. The resultant string shall not contain spaces. 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Information . 


f ilterable_ 


Name of NV pair is a string, NV ACK TIME defined in module 


ackTime 


bodY_f ields 


NotificationlRPConstDefs. 
Value of NV pair is a iRPTime. 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Information . 


f ilterable_ 


Name of NV pair is a String, NV ACK USER ID defined in module 


ackUserld 


bodY_f ields 


NotificationlRPConstDefs. 
Value of NV pair is a string. 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Information . 


f ilterable_ 


Name of NV pair is a string, NV ACK SYSTEM ID defined in module 


ackSystemId 


bodY_f ields 


NotificationlRPConstDefs. 
Value of NV pair is a string. 


additional 


One NV pair of 


It is an attribute of alarmlnformationBody. 


Information . 


f ilterable_body_ 


Name of NV pair is a string, NV ACK STATE defined in module 


ackState 


fields 


NotificationlRPConstDefs. 

Value of NV pair is a short defined by ACK STATE ACKNOWLEDGED 

and ACK STATE UNACKNOWLEDGED. 


reason 


One NV pair of 


It is an attribute of Notify Alarm List Rebuilt notification. 




f liter able_body_ 


Name of NV pair is a string, nv_reason, defined in module 




fields 


NotificationlRPConstDefs. 
Value of NV pair is a string. 


There is no 


remaining_ body 




corresponding SS 






attribute. 
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7 AlarmlRPNotifications Interface 

OMG CORBA Notification push operation is used to realise the notification of AlarmlRPNotifications. All the 
notifications in this interface are implemented using this push_structured_events method. 

7.1 Method push (M) 

module CosNotifyComm { 

Interface SequencePushConsumer : Notif yPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 

raises ( CosEventComm: : Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG TC Document telecom [6]). This data type is the same 
as a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of 
Structured Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specification 



/* ## Module: AlarmConstDef s 

This module contains commonly used definitions. 

#ifndef AlarmlRPConstDef s_idl 
tdefine AlarmlRPConstDef s_idl 

#include "CosNotif ication . idl" 

#pragma prefix "3gppsa5.org" 
module AlarmlRPConstDef s { 

/* 

This block identifies all TMN ITU-T defined event types used by Alarm 

IRP of this version. Their semantics are defined by ITU-T. Their 

encodings for this version of Alarm IRP are defined here. Other IRP 

documents, or other versions of Alarm IRP, shall identify their own 

ITU-T defined event types for their use. They shall define their encodings 

as well. Note all values are unique among themselves. Other IRP documents 

can use the same values. 

V 

const string ET_COMMUNICATIONS_ALARM = "xl"; 

const string ET_PROCESSING_ERROR_ALARM = "x2"; 

const string ET_ENVIRONMENTAL_ALARM = "x3"; 

const string ET_QUALITY_OF_SERVICE_ALARM = "x4"; 

const string ET_EQUIPMENT_ALARM = "x5"; 



/* 

This block identifies IRP defined, and not ITU-T defined, event types 

used by this Alarm IRP version. 

V 

const string NOTIFY_FM_NEW_ALARM = "xl"; 
const string NOTIFY_FM_CHANGED_ALARM = "x2"; 
const string NOTIFY_FM_ACK_STATE_CHANGED = "x3"; 
const string NOTIFY_FM_CLEARED_ALARM = "x4"; 
const string NOTIFY_FM_ALARM_LIST_REBUILT = "x5"; 

/* 

It indicates if an object has a back up. 

True implies backep up. False implies not backed up. 

V 

typedef boolean BackedUpStatusType; 

/* 

It indicates if the threshold crossed was in the up or down direction. 

V 
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enum ThresholdlndicationType {Up, Down}; 

/* 

It indicates if some observed condition is getting better, worse, 

or not changing. 

V 

enum TrendlndicationType {LessSevere, NoChange, MoreSevere}; 

/* 

It is used in a notification to report a changed attribute value. 

V 

struct AttributeValueChangeType { 
string attributeName; 

any oldValue; // type depends on attribute 
any newValue; // type depends on attribute 



typedef sequence <AttributeValueChangeType> AttributeChangeSetType; 

/* 

It is used in a notification to report a changed attribute value. 

V 

struct AttributeValueType { 
string attributeName; 
any value; // type will depend on the attribute 



typedef sequence <AttributeValueType> AttributeSetType; 



This block identifies the levels of severity. 
V 

const short PS_INDETERMINATE= 1; 

const short PS_CRITICAL= 2; 

const short PS_MAJOR= 3; 

const short PS_MINOR= 4; 

const short PS_WARNING= 5; 

const short PS_CLEARED= 6; 

/* 

This block identifies the acknowledgement state reported alarm. 

V 

const short ACK_STATE_ACKNOWLEDGED= 1; 

const short ACK_STATE_UNACKNOWLEDGED= 2; 

/* 

This block identifies the probable cause of a reported alarm. 

*/ 

const short PC_INDETERMINATE = 0; 

const short PC_ALARM_INDICATION_SIGNAL = 1; 

const short PC_CALL_SETUP_FAILURE = 2; 

const short PC_DEGRADED_SIGNAL_M3100 = 3; 

const short PC_FAR_END_RECEIVER_FAILURE = 4; 

const short PC_FRAMING_ERROR_M310 = 5; 

const short PC_LOSS_OF_FRAME = 6; 
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const short PC_LOSS_OF_POINTER = 7 ; 

const short PC_LOSS_OF_SIGNAL = 8 ; 

const short PC_PAYLOAD_TYPE_MISMATCH = 9; 

const short PC_TRANSMISSION_ERROR = 10; 

const short PC_REMOTE_ALARM_INTERFACE = 11; 

const short PC_EXCESSIVE_BIT_ERROR_RATE = 12; 

const short PC_PATH_TRACE_MISMATCH = 13; 

const short PC_UNAVAILABLE = 14; 

const short PC_SIGNAL_LABEL_MISMATCH = 15; 

const short PC_LOSS_OF_MULTI_FRAME = 16; 

const short PC_BACK_PLANE_FAILURE = 51; 

const short PC_DATA_SET_PROBLEM = 52; 

const short PC_EQUIPMENT_IDENTIFIER_DUPLICATION = 53; 

const short PC_EXTERNAL_DEVICE_PROBLEM = 54; 

const short PC_LINE_CARD_PROBLEM = 55; 

const short PC_MULTIPLEXER_PROBLEM_M3100 = 56; 

const short PC_NE_IDENTIFIER_DUPLICATION = 57; 

const short PC_POWER_PROBLEM_M3100 = 58; 

const short PC_PROCESSOR_PROBLEM_M3100 = 59; 

const short PC_PROTECTION_PATH_FAILURE = 60; 

const short PC_RECEIVER_FAILURE_M3100 = 61; 

const short PC_REPLACEABLE_UNIT_MISSING = 62; 

const short PC_REPLACEABLE_UNIT_TYPE_MISMATCH = 63; 

const short PC_SYNCHRONISATION_SOURCE_MISMATCH = 64; 

const short PC_TERMINAL_PROBLEM = 65; 

const short PC_TIMING_PROBLEM_M3100 = 66; 

const short PC_TRANSMITTER_FAILURE_M3100 = 67; 

const short PC_TRUNK_CARD_PROBLEM = 68; 

const short PC_REPLACEABLE_UNIT_PROBLEM = 69; 

const short PC_AIR_COMPRESSOR_FAILURE = 101; 

const short PC_AIR_CONDITIONING_FAILURE = 102; 

const short PC_AIR_DRYER_FAILURE = 103; 

const short PC_BATTERY_DISCHARGING = 104; 

const short PC_BATTERY_FAILURE = 105; 

const short PC_COMMERICAL_POWER_FAILURE = 10 6; 

const short PC_COOLING_FAN_FAILURE = 107; 

const short PC_ENGINE_FAILURE = 108; 

const short PC_FIRE_DETECTOR_FAILURE = 10 9; 

const short PC_FUSE_FAILURE = 110; 

const short PC_GENERATOR_FAILURE = 111; 

const short PC_LOW_BATTERY_THRESHOLD = 112; 

const short PC_PUMP_FAILURE_M3100 = 113; 

const short PC_RECTIFIER_FAILURE = 114; 

const short PC_RECTIFIER_HIGH_VOLTAGE = 115; 

const short PC_RECTIFIER_LOW_F_VOLTAGE = 116; 

const short PC_VENTILATION_SYSTEM_FAILURE = 117; 

const short PC_ENCLOSURE_DOOR_OPEN_M310 = 118; 

const short PC_EXPLOSIVE_GAS = 119; 

const short PC_FIRE = 120; 

const short PC_FLOOD = 121; 

const short PC_HIGH_HUMIDITY = 122; 

const short PC_HIGH_TEMPERATURE = 123; 

const short PC_HIGH_WIND = 124; 

const short PC_ICE_BUILD_UP = 125; 

const short PC_LOW_FUEL = 12 7; 

const short PC_LOW_HUMIDITY = 128; 

const short PC_LOW_CABLE_PRESSURE = 129; 

const short PC_LOW_TEMPERATURE = 130; 

const short PC_LOW_WATER = 131; 

const short PC_SMOKE = 132; 

const short PC_TOXIC_GAS = 133; 
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const short PC_STORAGE_CAPACITY_PROBLEM_M3100 = 151; 

const short PC_MEMORY_MISMATCH = 152; 

const short PC_CORRUPT_DATA_M310 = 153; 

const short PC_OUT_OF_CPU_CYCLES = 154; 

const short PC_SOFTWARE_ENVIRONMENT_PROBLEM = 155; 

const short PC_SOFTWARE_DOWNLOAD_FAILURE = 156; 

const short PC_ADAPTER_ERROR = 301; 

const short PC_APPLICATION_SUBSYSTEM_FAILURE = 302; 

const short PC_BANDWIDTH_REDUCTION = 303; 

const short PC_COMMUNICATION_PROTOCOL_ERROR = 305; 

const short PC_COMMUNICATION_SUBSYSTEM_FAILURE = 306; 

const short PC_CONFIGURATION_OR_CUSTOMIZING_ERROR = 307; 

const short PC_CONGESTION = 308; 

const short PC_CPU_CYCLES_LIMIT_EXCEEDED = 310; 

const short PC_DATA_SET_OR_MODEM_ERROR = 311; 

const short PC_DTE_DCE_INTERFACE_ERROR = 313; 

const short PC_EQUIPMENT_MALFUNCTION = 315; 

const short PC_EXCESSIVE_VIBRATION = 316; 

const short PC_FILE_ERROR = 317; 

const short PC_HEATING_OR_VENTILATION_OR_COOLING_SYSTEM_PROBLEM = 321; 

const short PC_HUMIDITY_UNACCEPTABLE = 322; 

const short PC_INPUT_OUTPUT_DEVICE_ERROR = 323; 

const short PC_INPUT_DEVICE_ERROR = 32 4; 

const short PC_LAN_ERROR = 325; 

const short PC_LEAK_DETECTION = 32 6; 

const short PC_LOCAL_NODE_TRANSMISSION_ERROR = 327; 

const short PC_MATERIAL_SUPPLY_EXHAUSTED = 330; 

const short PC_OUT_OF_MEMORY = 332; 

const short PC_OUTPUT_DEVICE_ERROR = 333; 

const short PC_PERFORMANCE_DEGRADED = 334; 

const short PC_PRESSURE_UNACCEPTABLE = 33 6; 

const short PC_QUEUE_SIZE_EXCEEDED = 339; 

const short PC_RECEIVE_FAILURE = 340; 

const short PC_REMOTE_NODE_TRANSMISSION_ERROR = 342; 

const short PC_RESOURCE_AT_OR_NEARING_CAPACITY = 343; 

const short PC_RESPONSE_TIME_EXCESSIVE = 344; 

const short PC_RETRANSMISSION_RATE_EXCESSIVE = 345; 

const short PC_SOFTWARE_ERROR = 34 6; 

const short PC_SOFTWARE_PROGRAM_ABNORMALLY_TERMINATED = 347; 

const short PC_SOFTWARE_PROGRAM_ERROR = 34 8; 

const short PC_TEMPERATURE_UNACCEPTABLE = 350; 

const short PC_THRESHOLD_CROSSED = 351; 

const short PC_TOXIC_LEAK_DETECTED = 353; 

const short PC_TRANSMIT_FAILURE = 354; 

const short PC_UNDERLYING_RESOURCE_UNAVAILABLE = 35 6; 

const short PC_VERSION_MISMATCH = 357; 

const short PC_A_BIS_TO_BTS_INTERFACE_FAILURE = 501; 

const short PC_A_BIS_TO_TRX_INTERFACE_FAILURE = 502; 

const short PC_ANTENNA_PROBLEM = 503; 

const short PC_BATTERY_BREAKDOWN = 504; 

const short PC_BATTERY_CHARGING_FAULT = 505; 

const short PC_CLOCK_SYNCHRONISATION_PROBLEM = 506; 

const short PC_COMBINER_PROBLEM = 50 7; 

const short PC_DISK_PROBLEM = 508; 

const short PC_EXCESSIVE_RECEIVER_TEMPERATURE = 510; 

const short PC_EXCESSIVE_TRANSMITTER_OUTPUT_POWER = 511; 

const short PC_EXCESSIVE_TRANSMITTER_TEMPERATURE = 512; 

const short PC_FREQUENCY_HOPPING_DEGRADED = 513; 

const short PC_FREQUENCY_HOPPING_FAILURE = 514; 

const short PC_FREQUENCY_REDEFINITION_FAILED = 515; 

const short PC_LINE_INTERFACE_FAILURE = 516; 
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const short PC_LINK_FAILURE = 517; 

const short PC_LOSS_OF_SYNCHRONISATION = 518; 

const short PC_LOST_REDUNDANCY = 519; 

const short PC_MAINS_BREAKDOWN_WITH_BATTERY_BACKUP = 52 0; 

const short PC_MAINS_BREAKDOWN_WITHOUT_BATTERY_BACKUP = 521; 

const short PC_POWER_SUPPLY_FAILURE = 522; 

const short PC_RECEIVER_ANTENNA_FAULT = 523; 

const short PC_RECEIVER_MULTICOUPLER_FAILURE = 525; 

const short PC_REDUCED_TRANSMITTER_OUTPUT_POWER = 52 6; 

const short PC_SIGNAL_QUALITY_EVALUATION_FAULT = 527; 

const short PC_TIMESLOT_HARDWARE_FAILURE = 52 8; 

const short PC_TRANSCEIVER_PROBLEM = 52 9; 

const short PC_TRANSCODER_PROBLEM = 530; 

const short PC_TRANSCODER_OR_RATE_ADAPTER_PROBLEM = 531; 

const short PC_TRANSMITTER_ANTENNA_FAILURE = 532; 

const short PC_TRANSMITTER_ANTENNA_NOT_AD JUSTED = 533; 

const short PC_TRANSMITTER_LOW_VOLTAGE_OR_CURRENT = 535; 

const short PC_TRANSMITTER_OFF_FREQUENCY = 53 6; 

const short PC_DATABASE_INCONSISTENCY = 537; 

const short PC_FILE_SYSTEM_CALL_UNSUCCESSFUL = 538; 

const short PC_INPUT_PARAMETER_OUT_OF_RANGE = 539; 

const short PC_INVALID_PARAMETER = 54 0; 

const short PC_INVALID_POINTER = 541; 

const short PC_MESSAGE_NOT_EXPECTED = 542; 

const short PC_MESSAGE_NOT_INITIALISED = 543; 

const short PC_MESSAGE_OUT_OF_SEQUENCE = 544; 

const short PC_SYSTEM_CALL_UNSUCCESSFUL = 545; 

const short PC_TIMEOUT_EXPIRED = 546; 

const short PC_VARIABLE_OUT_OF_RANGE = 54 7; 

const short PC_WATCH_DOG_TIMER_EXPIRED = 548; 

const short PC_COOLING_SYSTEM_FAILURE = 54 9; 

const short PC_EXTERNAL_EQUIPMENT_FAILURE = 550; 

const short PC_EXTERNAL_POWER_SUPPLY_FAILURE = 551; 

const short PC_EXTERNAL_TRANSMISSION_DEVICE_FAILURE = 552; 

const short PC_REDUCED_ALARM_REPORTING = 561; 

const short PC_REDUCED_EVENT_REPORTING = 5 62; 

const short PC_RECUCED_LOGGING_CAP ABILITY = 5 63; 

const short PC_SYSTEM_RESOURCES_OVERLOAD = 5 64; 

const short PC_BROADCAST_CHANNEL_FAILURE = 5 65; 

const short PC_CALL_ESTABLISHMENT_ERROR = 5 66; 

const short PC_INVALID_MESSAGE_RECEIVED = 567; 

const short PC_INVALID_MSU_RECEIVED = 568; 

const short PC_LAPD_LINK_PROTOCOL_FAILURE = 569; 

const short PC_LOCAL_ALARM_INDICATION = 570; 

const short PC_REMOTE_ALARM_INDICATION = 571; 

const short PC_ROUTING_FAILURE = 572; 

const short PC_SS7_PR0T0C0L_FAILURE = 573; 

const short PC_TRANSMISSION_FAILURE = 574; 



typedef sequence <string> Alarmlnf ormationldSeq; 
typedef CosNotif ication : : EventBatch Alarmlnf ormationSeq; 

}; 

#endif 



/* ## Module: AlarmlRPSystem 
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This module contains the specification of all operations of Alarm IRP Agent 
specified in Alarm IRP: IS version 1 and Alarm IRP: CORBA SS version 1:1. 

*/ 

#ifndef AlarmIRPSystem_idl 
♦define AlarmIRPSystem_idl 

♦include "CosNotif ication . idl" 
♦include "AlarmlRPConstDef s . idl" 
♦include "CommonlRPConstDef s . idl" 
♦pragma prefix "3gppsa5.org" 

module AlarmlRPSystem { 

/* 

System fails to complete the operation. System provides 

reasons whose semantics is outside the scope of this IRP. 

V 

exception AcknowledgeAlarms { string reason; }; 
exception UnacknowledgeAlarms { string reason; }; 
exception GetAlarmList {string reason; }; 
exception GetAlarmlRPVersion { string reason; }; 
exception GetAlarmCount { string reason; }; 
exception ParameterNotSupported { string parameter; }; 

//name of the unsupported parameter as defined in IDL. 
exception InvalidParameter { string parameter; }; 

//name of the parameter as defined in IDL 
exception OperationNotSupported {}; 
exception NextAlarmInf ormations { string reason; }; 



The Alarmlnf ormationlterator is used to iterate through a snapshot of 
Alarm Informations taken from the Alarm List when IRPManager invokes 
get_alarm_list . IRPManager uses it to pace the return of Alarm 
Informations . 

IRP Agent controls the life-cycle of the iterator. However, a destroy 
operation is provided to handle the case where IRPManager wants to stop 
the iteration procedure before reaching the last iteration. 
*/ 

interface Alarmlnf ormationlterator { 

This method returns between 1 and "how_many" Alarm Informations. The 
IRPAgent may return less than "how_many" items even if there are more 
items to return. "how_many" must be non-zero. Return TRUE if there 

may be more Alarm Information to return. Return FALSE if there are no 

more Alarm Information to be returned. 

If FALSE is returned, the IRPAgent will automatically destroy the 
iterator . 
V 

boolean next_alarmlnf ormations ( 
in unsigned short how_many, 
out AlarmlRPConstDef s :: Alarmlnf ormationSeq alarm_inf ormations 
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) 

raises (NextAlarmInf ormations, InvalidParameter ) ; 

This method destroys the iterator. 
*/ 

void destroy ( ) ; 

}; // end of Alarmlnf ormationlterator 



/* 

This interface specifies all methods supported by System as 
specified in 3GPP AlarmlRP : CORBA Solution Set version 1:1. 
V 

interface AlarmlRPOperations { 

CommonlRPConstDef 3 :: Signal ack;nowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string ack_user_id, 
in string ack;_system_id, 

out AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 
raises (AcknowledgeAlarms, ParameterNotSupported, InvalidParameter) ; 



CommonlRPConstDef s :: Signal unack:nowledge_alarms ( 

in AlarmlRPConstDef s : : Alarmlnf ormationldSeq alarm_inf ormation_id_list , 
in string ack;_user_id, 
in string ack_system_id, 

out AlarmlRPConstDef s : : Alarmlnf ormationldSeq 
bad_alarm_inf ormation_id_list 
) 

raises (UnacknowledgeAlarms, OperationNotSupported, ParameterNotSupported, 
InvalidParameter) ; 



/* 

This method returns Alarm Informations. 

If flag is TRUE, all returned Alarm Informations shall be 
in Alarmlnf ormationSeq that contains 0,1 or more Alarm Informations. 
Output parameter iter shall be useless. 

If flag is FALSE, no Alarm Informations shall be in Alarmlnf ormationSeq. 
IRPAgent needs to use iter to retrieve them. 
V 
AlarmlRPConstDef s :: Alarmlnf ormationSeq get_alarm_list { 

in string filter, 

out boolean flag, 

out Alarmlnf ormationlterator iter 
) 
raises (GetAlarmList, ParameterNotSupported, InvalidParameter) ; 



void get_alarm_count { 
in string filter, 
out long critical_count, 
out long major_count. 
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out long minor_count, 

out long warning_count , 

out long indeterminate_count , 

out long cleared_count 
) 

raises (GetAlarmCount, OperationNotSupported, ParameterNotSupported, 
InvalidParameter) ; 



CommonlRPConstDef 3 : : VersionNumberSet get_alarm_IRP_version 
raises (GetAlarmlRPVersion) ; 



}; 

#endif 
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